home *** CD-ROM | disk | FTP | other *** search
/ Aminet 38 / Aminet 38 (2000)(Schatztruhe)[!][Aug 2000].iso / Aminet / dev / gui / select_gc.readme < prev   
Encoding:
Text File  |  2000-07-01  |  5.2 KB  |  130 lines
  1. Short:    BOOPSI pop-up, cycle and button gadget
  2. Author:   tanti@intercom.it (Massimo Tantignone)
  3. Uploader: tanti@intercom.it (Massimo Tantignone)
  4. Version:  40.17
  5. Type:     dev/gui
  6. Requires: AmigaOS 3.0+
  7.  
  8. select.gadget 40.17 (7.6.2000) by Massimo Tantignone
  9.  
  10. The select.gadget is a shared library which, when opened, adds to the system
  11. a public BOOPSI gadget class called "selectgclass". This class implements a
  12. button-like selection gadget, with features similar to those of a traditional
  13. GadTools cycle gadget, but with the additional ability to open, when pressed,
  14. a pop-up menu which allows the user to pick his choice more easily.
  15.  
  16. The look and behavior of the gadget and its pop-up menu can be configured
  17. using the attribute tags of the class.
  18.  
  19. The library is freeware; if you use it, you are allowed to distribute it
  20. with your software.
  21.  
  22. Some highlights:
  23.  
  24. - A delay can be set for the appearance of the pop-up menu, allowing for a
  25.   gadget which reacts like a normal cycle gadget upon "quick" clicks, and
  26.   like a pop-up gadget if the mouse button is kept pressed a little longer.
  27.  
  28. - The pop-up menu can appear and disappear with a vertical "zoom" effect
  29.   whose duration is configurable.
  30.  
  31. - It is optionally possible to have a "sticky" pop-up menu which remains
  32.   open when the mouse button is released.
  33.  
  34. - The gadget can be made "quiet", that is, the currently selected item can be
  35.   not displayed. Useful to attach a small pop-up button to string gadgets.
  36.  
  37. - The gadget can be configured to always behave like a cycle gadget, and
  38.   even like a plain button gadget.
  39.  
  40. - The gadget can broadcast changes in its value to target objects via the
  41.   BOOPSI notification system.
  42.  
  43. - All changes done with SetGadgetAttrsA() to the gadget's position, size
  44.   and look are visually executed in real-time.
  45.  
  46. - The gadget's dispatcher is able to swap the stack when needed.
  47.  
  48. - The gadget can be added to requesters and window borders.
  49.  
  50. - The pop-up menu can have a drop shadow.
  51.  
  52. - The gadget's "pop-up" symbol can be placed at the left side, at the right
  53.   side, or it can also not appear at all; its width is also configurable.
  54.   The gadget's default imagery for the symbol is fully scalable, and it can
  55.   be replaced by the application with a custom image.
  56.  
  57. - The default values for unspecified attributes can be globally set by the
  58.   user with an ASCII preferences file; the changes are applied in real-time
  59.   (to gadgets created afterwards) via file notification.
  60.  
  61. Furthermore, the library offers some functions which allow to "transform"
  62. a normal gadget into a custom gadget having (almost) the same features of
  63. the "selectgclass" gadgets.
  64.  
  65. This way it's possible, for example, to create GadTools GENERIC_KIND gadgets
  66. and turn them into pop-up gadgets, obtaining all the benefits of this type
  67. of gadgets while also keeping the benefits of the GadTools automatic gadget
  68. creation (and deletion) system.
  69.  
  70. Lastly, this gadget class supports VisualPrefs and takes full advantage of
  71. the graphic enhancements it brings to the system.
  72.  
  73. Changes since version 40.16:
  74.  
  75. · Now the pop-up menu panel shows a real drop shadow (not dithered)
  76.   on hicolor and truecolor screens.
  77.  
  78. · Now the pop-up menu panel can have a transparency effect on hicolor
  79.   and truecolor screens.
  80.  
  81. · The background is visible again through corners of the menu panel
  82.   when the "round edges" option of VisualPrefs is active.
  83.  
  84. Changes since version 40.15:
  85.  
  86. · Fixed a deadlock problem likely to happen when many gadgets of
  87.   this class were rendered simultaneously by different processes
  88.   (and in some other rare circumstances).
  89.  
  90. Author:
  91.  
  92. Massimo Tantignone
  93. Via Campagnoli, 4
  94. 28100 Novara (NO)
  95. ITALY
  96.  
  97. E-mail: tanti@intercom.it
  98.  
  99.  
  100. ============================= Archive contents =============================
  101.  
  102. Original  Packed Ratio    Date     Time    Name
  103. -------- ------- ----- --------- --------  -------------
  104.    25884   15395 40.5% 20-Jun-00 10:38:34 +select.gadget
  105.      270     161 40.3% 15-Jun-00 12:35:18 +select.prefs
  106.      715     287 59.8% 12-May-98 10:30:34 +selectgadget_protos.h
  107.     2266     717 68.3% 15-Jun-00 12:34:00 +select.h
  108.      462     177 61.6% 12-May-98 10:56:52 +selectgadget_pragmas.h
  109.      210     139 33.8% 12-May-98 10:58:54 +selectgadget.h
  110.     4810    1425 70.3% 26-May-98 20:21:46 +Install
  111.      681     344 49.4% 26-May-98 23:17:14 +Install.info
  112.     2552    1032 59.5% 15-Jun-00 12:31:52 +ReadMe.user
  113.      464     213 54.0% 26-May-98 12:24:12 +ReadMe.user.info
  114.    45860   13844 69.8% 16-Jun-00 11:33:34 +select.doc
  115.      464     212 54.3% 16-May-98 15:47:34 +select.doc.info
  116.    49010   14484 70.4% 16-Jun-00 11:34:02 +select.guide
  117.      468     226 51.7% 26-May-98 23:17:14 +select.guide.info
  118.      324     207 36.1% 12-May-98 10:28:34 +selectgadget_cl.fd
  119.     9516    5951 37.4% 15-Jun-00 12:41:16 +SelGadgTest
  120.     9471    2266 76.0% 15-Jun-00 12:39:22 +SelGadgTest.c
  121.      464     227 51.0% 26-May-98 23:17:14 +SelGadgTest.c.info
  122.      454     188 58.5% 26-May-98 23:17:46 +SelGadgTest.info
  123.     9412    5990 36.3% 15-Jun-00 12:41:30 +SGCustomTest
  124.     7311    2179 70.1% 15-Jun-00 12:40:20 +SGCustomTest.c
  125.      464     223 51.9% 26-May-98 23:17:14 +SGCustomTest.c.info
  126.      454     191 57.9% 26-May-98 23:17:14 +SGCustomTest.info
  127.     1220     412 66.2% 21-Jul-99 11:22:52  select_gc.info
  128. -------- ------- ----- --------- --------
  129.   173206   66490 61.6% 26-Jun-100 07:33:36   24 files
  130.